home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / text / hyper / hsc_source.lha / source / README < prev    next >
Encoding:
Text File  |  1996-09-19  |  2.6 KB  |  98 lines
  1.  
  2. hsc source archive
  3. ==================
  4.  
  5. This archive contains the sources for hsc. They are distributed under
  6. GNU General Public License (for details, see file "COPYING" in this
  7. directory).
  8.  
  9. IMPORTANT: If you've compiled older versions of hsc before, remove 
  10. all files of the old sources before you continue.
  11.  
  12. There are two makefiles, but only one is required to create the 
  13. binaries:
  14.  
  15. =====================
  16. USING "MAKEFILE.DODL"
  17. =====================
  18.  
  19. "Makefile.dodl" is designed to compile with CC under an Unixoid
  20. environment without any special options or debugging-features
  21. enabled.
  22.  
  23. Use
  24.  
  25.     make -f Makefile.dodl
  26.  
  27. to start the compilation-sequence.
  28.  
  29. ================
  30. USING "MAKEFILE"
  31. ================
  32.  
  33. "Makefile" uses conditionals for figuring out the compiler and
  34. environment. You can change the environment commenting-out the
  35. required symbol. GNUmake v3.74 is recommended.
  36.  
  37. At the moment, only AmigaOS and Unix are supported. For AmigaOS, you
  38. require GCC or SAS/c, for Unix,  GCC and CC are supported.
  39.  
  40. This makefile supports three compilation modes: "debug" for a
  41. debugging version that includes all debugging information, supports
  42. a source-level memory-tracking and enables some additional output
  43. and plausibility checks. "norm" links only some debugging
  44. information, and "optim" strips all debugging information and
  45. creates an optimized executable.
  46.  
  47. After having done this, use
  48.  
  49.     make
  50.  
  51. to start the compilation-sequence.
  52.  
  53. -----------------
  54. COMPILER WARNINGS
  55. -----------------
  56. Normally, no warnings should show up, exept about ununsed functions
  57. and parameters. This is because some parameters and functions are
  58. only used by the debugging-version.
  59.  
  60. ------------
  61. OPTIMISATION
  62. ------------
  63. If you set the compilation mode to "optim", the binary will be 
  64. optimised for small code.
  65.  
  66. If the optimised version causes serious problems, try to compile
  67. with compilation mode set to "norm". There are loads of buggy
  68. optimisers out there..
  69.  
  70. ========
  71. PROBLEMS
  72. ========
  73.  
  74. If you modify the Makefile, make sure that your editor does not
  75. convert TABs to blanks.
  76.  
  77. Make sure that you didn't extract the source-archive to a path where
  78. an old source-archive has already been located; remove older 
  79. versions before you extract the sources.
  80.  
  81. Problems might occure, if your compiler does not support ANSI-C (as
  82. "cc" under SunOS on my university - Pfthuahuhahua!), but I won't
  83. care about this.
  84.  
  85. ============
  86. THE BINARIES
  87. ============
  88.  
  89. If nothing went wrong, you now should have created two files:
  90.  
  91.     hsc/hsc
  92.     hscdepp/hscdepp
  93.  
  94. These are the executables. Now follow the installation-instructions 
  95. of the documentation that came with the main-archive.
  96.  
  97. Thomas Aglassinger <agi@giga.or.at>
  98.